package com.example.controller;

import com.mybatisflex.core.paginate.Page;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import jakarta.annotation.Resource;
import com.example.entity.City;
import com.example.service.CityService;
import org.springframework.web.bind.annotation.RestController;
import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import java.io.Serializable;
import java.util.List;

/**
 * 城市表 控制层。
 *
 * @author Administrator
 * @since 2023-10-12
 */
@RestController
@Tag(name = "城市表接口")
@RequestMapping("/city")
public class CityController {

    @Resource
    private CityService cityService;

    /**
     * 添加城市表。
     *
     * @param city 城市表
     * @return {@code true} 添加成功，{@code false} 添加失败
     */
    @PostMapping("save")
    @Operation(summary="保存城市表", description="保存城市表")
    public boolean save(@RequestBody @Parameter(description="城市表")City city) {
        return cityService.save(city);
    }

    /**
     * 根据主键删除城市表。
     *
     * @param id 主键
     * @return {@code true} 删除成功，{@code false} 删除失败
     */
    @DeleteMapping("remove/{id}")
    @Operation(summary="根据主键删除城市表", description="根据主键删除城市表")
    public boolean remove(@PathVariable @Parameter(description="城市表主键")Long id) {
        return cityService.removeById(id);
    }

    /**
     * 根据主键更新城市表。
     *
     * @param city 城市表
     * @return {@code true} 更新成功，{@code false} 更新失败
     */
    @PutMapping("update")
    @Operation(summary="根据主键更新城市表", description="根据主键更新城市表")
    public boolean update(@RequestBody @Parameter(description="城市表")City city) {
        return cityService.updateById(city);
    }

    /**
     * 查询所有城市表。
     *
     * @return 所有数据
     */
    @GetMapping("list")
    @Operation(summary="查询所有城市表", description="查询所有城市表")
    public List<City> list() {
        return cityService.list();
    }

    /**
     * 根据城市表主键获取详细信息。
     *
     * @param id 城市表主键
     * @return 城市表详情
     */
    @GetMapping("getInfo/{id}")
    @Operation(summary="根据主键获取城市表", description="根据主键获取城市表")
    public City getInfo(@PathVariable Serializable id) {
        return cityService.getById(id);
    }

    /**
     * 分页查询城市表。
     *
     * @param page 分页对象
     * @return 分页对象
     */
    @GetMapping("page")
    @Operation(summary="分页查询城市表", description="分页查询城市表")
    public Page<City> page(@Parameter(description="分页信息")Page<City> page) {
        return cityService.page(page);
    }

}
